package org.example.flea_market_mvc.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.example.flea_market_mvc.entity.Ratings;

import java.util.List;

/**
 * 用户评价Mapper接口，提供用户评价相关的数据库操作方法
 */
@Mapper
public interface RatingsMapper {

    /**
     * 插入一条用户评价记录
     * @param ratings 用户评价实体对象
     * @return 插入成功返回1，失败返回0
     */
    int insert(Ratings ratings);

    /**
     * 根据评价记录ID删除用户评价记录
     * @param id 评价记录ID
     * @return 删除成功返回1，失败返回0
     */
    int deleteById(Integer id);

    /**
     * 更新用户评价记录
     * @param ratings 用户评价实体对象，包含要更新的信息
     * @return 更新成功返回1，失败返回0
     */
    int update(Ratings ratings);

    /**
     * 根据评价记录ID查询用户评价记录
     * @param id 评价记录ID
     * @return 用户评价实体对象，如果未找到则返回null
     */
    Ratings selectById(Integer id);

    /**
     * 查询所有用户评价记录
     * @return 用户评价记录列表
     */
    List<Ratings> selectAll();

    /**
     * 查询用户平均评分（综合多维度）
     */
    Double getUserAverageRating(@Param("userId") Integer userId);
}